copyResource
Type
function
Summary
Copies a resource from one Mac OS file to another.
Syntax
copyResource(<file>, <destinationFile>, <resType>,{<resID> | <resName>}[, <newID>])
Description
Use the copyResource function to copy resources (such as icons, externals, and version resources) from one file to another.
If you don't specify a newID, the new resource has the same ID as the original resource. Specifying a newID does not change the resource ID of the original resource in the file; it only affects the copy in the destinationFile.
Parameters
| Name | Type | Description |
|---|---|---|
file | The name and location of the file containing the resource. If you specify a name but not a location, LiveCode assumes the file is in the defaultFolder. | |
destinationFile | The name and location of the file you want to copy the resource to. | |
resType | The 4-character type of the resource you want to move. | |
resID | integer | An integer that specifies the resource ID of the resource you want to copy. |
resName | The name of the resource you want to copy. | |
newID | integer | An integer that specifies the resource ID for the newly-copied resource. |
Examples
get copyResource("Template","New Build","vers",1,1)
put copyResource(theFile,anotherFile,"XCMD","SetPort") into trashVar
get copyResource(field "Source",currentFile,nextResource,200)
Value
| Name | Type | Description |
|---|---|---|
return | ||
the result | If the file does not exist, the result is set to "can't find file". If the destinationFile does not exist, the copyResource function creates the file, but the result is set to "can't create resource fork for destination file". If the destinationFile exists but has no resource fork. the copyResource function creates the resource fork and copies the resource to it. If the destinationFile is open, the result is set to "Can't open resource fork". |
Related
command: copy
control structure: function
function: result, setResource
glossary: resource fork, resource, Mac OS, return
keyword: file
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
Platforms
desktop